Skip to content

docs(config): show each example in its own section and version - #4866

Draft
thetaPC wants to merge 1 commit into
chore/require-descriptionsfrom
docs/config-examples
Draft

thetaPC wants to merge 1 commit into
chore/require-descriptionsfrom
docs/config-examples

Conversation

@thetaPC

@thetaPC thetaPC commented Nov 18, 2026

Copy link
Copy Markdown
Contributor

Issue URL: N/A

What is the current behavior?

  • The Fallbacks section shows the Overrides example, and Overrides shows Fallbacks: PerPlatformFallbackExample imports per-platform-overrides, and the reverse.
  • The v8 Config page shows the v9 examples, because it imports @site/docs/.... v8 readers are told to import IonicModule from @ionic/angular/lazy, which v8 doesn't have, under a v9 deprecation note. v8's own copies of the examples are never used.

What is the new behavior?

  • Each section imports its own example.
  • The Config page imports its examples relatively, such as ./config/_global.mdx, so each version loads the copies next to it. A version cut copies the page and its examples together, so the next version stays correct without edits.
  • v7 is archived, but it gets the same imports and _ prefix, since its old paths point at files docs: require a frontmatter description on every page #4865 renames.

Does this introduce a breaking change?

  • Yes
  • No

Other information

@site/docs was never a deliberate choice. #2727 created the page with @site/docs in docs/ and relative imports in v6, and each version cut since has copied @site/docs forward.

Compared with a build of #4865, only the docs and v8 Config pages and their Markdown versions change.

Stacked on #4865.

@thetaPC
thetaPC added this pull request to stack #4861 November 18, 2026 03:46
@vercel

vercel Bot commented Nov 18, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
ionic-docs Ready Ready Preview Nov 18, 2026 3:46am UTC

Request Review

This branch was successfully deployed

1 active deployment
Preview — f80b51a1 Deployed Nov 18, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant